---
layout: docs
page_title: 'nomad alloc command reference'
description: |
  The `nomad alloc` commands interact with allocations. Access allocation directories, display status and health checks, stream task logs, run commands inside an allocation, and signal a running allocation. You can also stop, reschedule, and restart a running allocation.
---

# `nomad alloc` command reference

The `alloc` command is used to interact with allocations.

## Usage

Usage: `nomad alloc <subcommand> [options]`

Run `nomad alloc <subcommand> -h` for help on that subcommand. The following
subcommands are available:

- [`alloc checks`][checks] - Outputs service health check status information.
- [`alloc exec`][exec] - Run a command in a running allocation
- [`alloc fs`][fs] - Inspect the contents of an allocation directory
- [`alloc logs`][logs] - Streams the logs of a task
- [`alloc restart`][restart] - Restart a running allocation or task
- [`alloc signal`][signal] - Signal a running allocation
- [`alloc status`][status] - Display allocation status information and metadata
- [`alloc stop`][stop] - Stop and reschedule a running allocation

[checks]: /nomad/commands/alloc/checks 'Outputs service health check status information'
[exec]: /nomad/commands/alloc/exec 'Run a command in a running allocation'
[fs]: /nomad/commands/alloc/fs 'Inspect the contents of an allocation directory'
[logs]: /nomad/commands/alloc/logs 'Streams the logs of a task'
[restart]: /nomad/commands/alloc/restart 'Restart a running allocation or task'
[signal]: /nomad/commands/alloc/signal 'Signal a running allocation'
[status]: /nomad/commands/alloc/status 'Display allocation status information and metadata'
[stop]: /nomad/commands/alloc/stop 'Stop and reschedule a running allocation'
